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abstract 

This thesis describes the concept of an input and output 
filter for the Warfare Environment Simulator (WES). The 
filter is comprised of two computer programs which were 
written in the "c" programming language. The main program 
examines the input to the filter on a character by character 
basis, and provides two basic capabilities which are not 
currently available in WES. The first is the ability to 
edit or create files, and the second is a facility for 
translating abbreviations (macros) into WES commands. The 
macros may include values which are substituted into 
variables in the commands as they are sent to WES. The 
second program buffers the output from WES as directed by 
the main program to avoid an interleaving of output when a 
process other than WES is in use. 
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I. BACKGROUND 



A. OBJECTIVE 

The objeciive of this thesis was to develop a "filter" 
program for the Warfare Environment Simulator (WES). It was 
envisioned that the program would continuously examine the 
characters which were being typed in to determine if a 
predetermined set of characters (a "string") was present, 
and if so, to perform some corresponding, and also 
predetermined function. Additionally, the program would he 
capable of buffering output from WES in the event that 
output from some other process is being displayed on the 
terminal. For examtpie, this would allow for the use of an 
editor, since the output from WES could be saved, and later 
displayed on the terminal when the editing session was 
completed. This objective was met in the manner described 
in the following section. 

B. INTRODUCTION 

In achieving the stated objective, two major questions 
had to be answered. The first question was "What functions 
would be most useful in tne implementation cf the filter 
concept ?" Those who were most familiar with The operation 
of WES were the least concernec. about functions which would 
make it easier to use: as usual, once a system has already 
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been learned, airr.osi by definition its use becorres easy. On 
the other hand, since the majority of- those who have tried 
to use WES have been initially overwhelmed by its 
complexity, they provided many suggestions as to what 
capabilities the filter program should provide. The second 
question was ’How will the program determine when a 
particular function is to be performed ?," or similarly, 

”How will the user indicate that a function is to be 
performed ?" The answer to this question will be addressed 
first. 

To enable a user of the program to distinguish between 
input to WES end a "command" to the filter program, a 
special character (the "?") was chosen. It must precede any 
input which is to be interpreted by the program. Eor 
example, if "help" was typed in, it would be passed through 
the filter to WES without any action being taken by the 
program, while "$help” would cause the program to display 
the help file without sending any characters to WES. 

Answering the first question was a much more difficult 
task. The answer lies in the intersection of two lists of 
capabilities - a list of what would be most useful to 
implement, and a list of what is reasonable to imiplenent. 

The adjective reasonable in this context means feasible in 
terms of the limitations imposed by: (l) the programming 
language being used ("c"), (2) the operating system (UNIX) 
and the standard routines it has access to, and (3) the time 
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available to write the program or subroutine. All of these 
factors were taken into account when the filter concept was 
developed and implemented. 

A review of the capabilities which were common to the 
two lists resulted in a decision to include the following 
functions in the filter program: 

1. An editing capability for reviewing old files, or 
creating new ones . 

2. A means of identifying certain brief strings of input, 
and sending a much more complex series of characters to 
WES . 

3. A mechanism for substituting arguments provided as input 
for variables in predefined WZS commands. 

4. A "default" mode of operation in which input provided tc, 
as well as output from, WES occurs as it would if the 
filter program were not being used. 

A detailed description of how these functions are performed 

is the topic of the next section. 
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II. PROGRAM STRUCTURI AND DESCRIPTION 



A. THE MAIN PROGRAM 
1 . General 

The main program receives input from the Reyboari, 
checks for the special character, and either passes the 
other characters to telnet or responds to the ’’special" 
character strings as if they were commiands. The special 
character for this program is the dollar sign A 

causes the program to compare the characters immediately 
following it to a list of strings of characters which 
correspond to subroutines which are to he performed. If the 
input string does not match a string in the list, an error 
message is generated and nc action is taken. 

These two modes of operation, as indicated in the 
source code, are (1) the "default" mode, and (2) the "call 
subroutine" mode. In the former, all input characters are 
sent to telnet, with the echo (a copy of the character on 
the terminal screen) Deing provided by the remote host. In 
the latter, the input characters are used to control the 
program, which performs various functions which are not 
otherwise available while running the V/ES program. These 
functions include listing the available files, invoking the 
editor, and expanding abbreviations (later referred to as 
macros) into standard ’«SS commands. 
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The filter process was designed to be "file driven". 
For the most part, the text which is required for display in 
the main program- is contained in separate files which are 
opened, read, and copied to the terminal. This allows for 
the text to be easily changed as necessary, and results in a 
shorter program. This tradeoff is in favor of both 
simplicity, and flexibility for future expansion or 
modification. It should be noted that this flexibility does 
not extend to changing the menu text without changing the 
switches in the main program which control the response of 
the program to the selection of an option. 

Aside from the subroutines, the overall program is 
divided into three distinct parts (Figure 1). The main 
program controls the overall filter process. It also causes 
an asynchronous program to be executed which receives the 
output from telnet (which is the output from WES in this 
case), and either sends it directly to the terminal or 
stores it while ether information is being displayed. This 
buffer program is discussed in more detail in section II C. 
The third part of the program is the telnet process, which 
will be discussed in section II D. 
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Figure 1. PROGRAM STRUCTURE 
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2 . 



The Subroutines 



The subroutine "init()" executes the actions which 
are required to begin using the program (Figure 2). The 
most significant of these actions are as follows: 



1. Reading the macros and their WES equivalents into an 
array so that the program can rapidly determine if an 
input string is a valid macro, and if it is, output the 
WES command. 

2. Determining the type of terminal that is being used, so 
that the proper (either line or full screen) editor can 
be called, if required. 

3. Determining whether the program will be used with telnet, 
or for training on the capabilities and operation of the 
program . 

The subroutine which controls the display and 
selection of options is "menu()”. A text file containing 
the menu of options is displayed, and a number corresponding 
to the option selected is entered (Figure 3). The 
appropriate subroutine is then called. After an option has 
been completed, the menu is displayed again, and another 
choice may be made. Returning to the standard WES input 
mode is the last option on the menu. 

The following options are available in the menu 
(with the exception of ’’4" which has not been implemented): 

1. Editing an existing file, or creating a new file. 

2. Displaying the current list of filenatres. 

3. Editing the list of macros and their WES equivalents. 

4. Preparing an order for input to WES. 

5. Displaying the current list of orders. 

e. Returning to the standard WES input mode. 
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I THE FILE "mac .ten" IS OPENED AND READ INTO ] 
[ THE ARRAY "mac [] " IN THE MAIN PROGRAM ] 

Fri Mar 5 iil:06:10 PST iy82 
WHAT TYPE OF TERMINAL ARE YOU WOREING ON ? 

1. Ann Arbor. 

2. Digital VT 100. 

3. A.D.M.3 or Tektronix. 

type in 1, 2 OR 

1 < 1 A "l" WAS TYPED IN HERE TO INDICATE THAT ] 

[ THE TERMINAL BEING USED WAS AN ANN ARBOR ] 

WELCOME - You have the following options; 

1. Telnet to Tops20 and log in au t oma t ica 1 ly . 

2. Link to another terminal in the C-3 Lab 

(primarily for training on this program). 

type IN 1 OR 

2 < L A " 2 " WAS typed in HERE TO INDICATE THAT ] 

[ PROGRAM WAS TO BE USED FOR TRAINING ] 

[ THIS RESULTS IN A CALL TO " c3LabLi nk ( } " ] 



Figure 



C. * 



SUBROUTINE "initO" 



t TYPING '$ AND A CASRIAGE RETURN CAUSES ] 
[ THE FOLLOWING MENU TO BE DISPLAYED ] 



MENU #1 - You have the following options: 

1. Review/Edit an existing file. 

2 . See the current list of filenames. 

3. Review/Sdit the current macro list. 

4. Prepare an order. 

5. See the current list of orders. 

6. Cnit (return to standard WES input mode). 



Type in 1, 2, 3, 4, 5, or 6. 



6 < L A '*6" TYPED HERE CAUSES THE PROGRAM TO ] 

[ RETURN TO THE STANDARD WES INPUT MODE ] 



[ OPTION 4 HAS BEEN INCLUDED BOTH HERS AND 1 
[ IN THE SOURCE CODE TO DEMONSTRATE AN ] 
[ OPTION WHICH MAY BE ADDED TO THE PROGRAM ] 
[ IN TEE FUTURE, AND AS AN EXAMPLE OE HOW ] 
[ EASILY A MODULE MAY BE ADDED TO THE ] 
[ PROGRAM ] 



0 < [ THIS IS THE OPERATING SYSTEM PROMPT FROM ] 

[ TOPS20, WHICH IS DISPLAYED AFTER OPTION ] 
[ "6” HAS BEEN SELECTED ] 



Figure 3. SUBROUTINE "rrenuO” 



Items 4 and 5 have oeen included in the menu as an example 
of a potential area for expanding the program beyond its 
capabilities as it is currently written. If option 4 (order 
preparation} is selected, a message is returned stating that 
the option is not implemented yet. Option 5, however, does 
list the files in the directory which end in ”.ord” i this 
can easily be changed to any ending which would readily 
identify the files containing standard groups of orders for 
input to WES. This will be discussed in more detail in 
Chapter IV. 

The most complex series of subroutines begins with 
’’macro()’’ (Figure 4). This family of routines includes 
”macro()”, ”next()", ”xlate()", and ”sub()”. They are used 
to accomplish two closely related tasks, both of which are 
controlled by ”macro()”. 

The first task is the substitution of a WES command, 
or a series of WES commands fcr an abbreviation (macro) 
which is defined ana entered into the file "mac. text”. This 
file may be changed at ary time by choosing m,enu option 3. 
The file is stored in an array in the program to facilitate 
a rapid search and translate process. To expand a simple 
macro, a is entered, followed by the macro and a 

carriage return. If the macro is to be used at the 
beginning (or in the middle) of a sentence, the macro is 
ended with the character "escape". 
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[ "rracroO” EXAMINES THE INPUT FOLLOWING A ] 
[ IF THE INPUT DOES NOT CCHBSSPOND TO ] 
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I I 

^ K 



+ + 

1 I 

I I 
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I I 

I I 

-}. + 



[ SUCCESSIVE CALLS TO NEXT ARE REQUIRED TO ] 
I DETERMINE IF A MACRO EXISTS WHICH ] 
[ MATCHES THE CHARACTERS WHICH ARE BEING ] 
I TYPED IN. ] 

[ IF A CHARACTER IS TYPED IN WHICH DOES ] 
[ NOT MATCH A MACRO IN THE CURRENT LIST, ] 
[ AN ERROR MESSAGE IS DISPLAYED ] 

[ THE ERROR MESSAGE - ''NOT A VALID MACRO” ] 



Figure 4. SUBROUTINES ”macro()” AND "next()" 



Ttiis causes the expansion of the macro to he sent to WES, 
but it is net foliewed by a carriage return. This type of 
expansion is useful for senaing commands which are 
frequently used during the conduct of a game, especially 
since a new macro can he added to the file while the game is 
in progress. 

The second tasic is an extension of the first in 
which a macro with arguments is expanded into one or more 
WES commands. After the macro and its expansion are found 
in the array, the arguments are substituted into their 
appropriate places in the commands as they are sent tc WES. 
For example, if ’’^a tk .a7( nimi tz ,4 , fl 1 1 ) ” is entered, the 
following actions are taken. "Macro()" is called as soon as 
enough characters are entered to aetermine that the input is 
not a request for one of the programs standard routines, 
e.g. "help()’’. In this case, the letter "a" is sufficient 
to make this decision. Successive calls to ”next()” are 
made as required to match the string cf characters as it is 
being typed in. This serves two functions. First, no delay 
is required tc locate the macro and send the WES equivalent. 
Second, as soon as a character is typed in which causes the 
string of characters to be different from the list of macri's 
in "mac . text" , an error message ("ncT A VAIIE I^ACHC") is 
displayed and the program returns to the standard WES input 
mode . 
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Afier ”$aik .a7( niiri tz ,4 , f 1 tl ) " is entered., it must 
te followed, ty a carriage return or an escape character. In 
either case, the arguments (nimitz, 4, and fitl) are 
substituted into the appropriate places in the command which 
is sent to WES. In this case, the output to WES would he 
"EOR nimitz launch 4 A7E ELTl 1Z0 240 1000". Since this is 
a macro with arguments, the substitution and output to WES 
is accomplished by ”sub()". If the macro did not have any 
arguments, the translation and output would have been 
accomplished ty "xlate()" (Figure 5). As mentioned earlier, 
following a macro with a carriage return causes a carriage 
return to be sent to WES, while an escape character allows 
the macro expansion to be used in the context of a WES 
command . 

”Edit()" is the routine which provides the 
capability to review an existing file or to create a new 
file. Since the type of terminal being used is determined 
in ”init()'’, the corresponding type of editor can be called. 
The distinction between the different types of terminals 
must be made by the program, since the UNIX operating system 
is not capable of matting the distinction on its own. After 
entering 'edit()'', the name of the file which is to be 
edited must be entered. Since the program examines every 
character which is typed in, if a mistaice is made in typing 
in the file name, no provisions exist for deleting 
characters which have been typed incorrectly. To insure 



I “liaieO" IS CALLED BY “macroO’’ TO EXPAND ] 
[ A MACHO IftHICH DOES NOT CONTAIN VARIABLES ] 




OUTPUT 
TO WES 



-> 



1 i/ 


1 I 

i i 


1 m 3. c r 0 V / 1 

! 1\ 


1 n 6 X u V / i 

I 1 

1 1 




OUTPUT 
TO WES 



-> 



[ "subO" IS CALLED BY "macrcO" TO EXPAND ] 
[ A MACHO U IT CONTAINS VARIABLES FOR ] 
I WHICH SUBSTITUTIONS MUST BE MADE ] 



Figure 5. SUBROUTINES "xlateO" AND "sub() 
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thai this is not a prohiem, the prograrr asks for a 
verification (a "y" cr "n”) of the narre which has been 
entered. Once in the editor, the prograrr is no longer 
examining the input, and the editor is used as it normally 
would be. As a miniirum, this requires the user to know what 
command must he enterea in order to exit from the editor, 
since the program cannot be of any assistance. Once the 
editing session is complete, tne menu is displayed and 
another selection must be made. Although the file 
containing the macros may be edited in this fashion, a menu 
option has been provided to accomplish this directly (Figure 
6 ). 

The second option on the menu is to display the list 
of filenames which are available in the directory which was 
used to run the filter program. "Dispiay()" is intended to 
provide a list of files if a particular file is to be edited 
or reviewed, but the exact name cannot be remembered. It 
presents the file names in a column format, so that all the 
files in most directories will be available on the screen at 
one time (Figure 6). To return to the menu, any character 
may be typed in. 

As previously mentioned in the discussion on 
”edit()", the subroutine "rvwMacroO" automatically calls 
the macro expansion file ("mac. text") into the appropriate 
editor (Figure 6). "Rvwl^acro ( ) " is called by selecting item 
3 on the menu. This routine was included as an explicit 







[ INPUT THE NAME 01 ] [ AN EDITOR IS INVOKED ] 
L TEE FILS TO BE ] [ WHICH CORRESPONDS TO ] 
[ REVIEWED OR ] [ TEE TYPE OF TERMINAL ] 
L CREATED ] [ BEING USED ] 



+ ^ 

1 t 
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+ ^ 
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[ A COMPLETE LIST OF TEE FILENAMES WEIGH ARE ] 
[ AVAILABLE IN THE DIRECTORY BEING USED ARE ] 
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I 



[ THE FILE "mac. text" WHICH CONTAINS THE LIST ] 
L Of MACROS AND THEIR WES ECUIVALSNTS IS ] 
[ CALLED INTO THE EDITOR WHICH CCRRSSPCNDS TO ] 
[ THE TYPE OF TERMINAL BEING USED ] 



Figure 6. SUBROUTINES "ed i i ()' , "d i splay () ” and ' rvwMacroO 



option since the macro expansion capability is the most 
powerful option available in the program. In this light, 
this ability to rapidly add to or change the list of macros 
while the WES program is running should prove to be a 
desirable feature. 

As mentioned earlier, the subroutine " orderPrep ( ) ” 
is not yet Implemented, but has been included for the 
following reasons. The preparation of a series of WES 
commands, referred to here as an order, was suggested as a 
useful feature to be added to the program. In the context 
of WES such a series of commands would be called a "plan”. 
This routine is envisioned to use a menu, from which small 
plans would be selected and combined to form a complete 
plan. The overall plan would contain standardized control 
characters, which would be replaced by arguments in a 
routine similar to "sub()". The plan could then be typed 
out or edited prior to being sent to WES. Although this 
description is somewhat limited, it should provide both an 
explanation of the concept and a framework on which to build 
if it is to be implemented. 

The selection of the next item on the menu causes 
’’ rvwOrders ( ) " tc be executed. This routine is similar to 
”display()", in that it lists the available files of a 
certain type , in this case files which contain orders. 

These files are currently assumed to have a file type, or 
suffix, of ".crd". This suffix can be easily changed within 
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the program to one which is more easily remembered by the 
user. A series of suffixes can also be entered in the 
program if a more general listing of order files is desired. 

The next subroutine is "tnTops20 ( ) ” , which performs 
a number of functions if the option to use telnet is chosen 
(Figure 7). first, it requests that two processes be 
initiated - telnet and "readTN”. The output from telnet 
(WES) is sent to the background program, "readTN". This 
connection is established using the UNIX pipe function (1). 
However, the connection between the filter program and 
telnet is created in the program using ”popen()". The pipe 
facility can not be used by the filter since a pipe sends 
all of the output of the first process to the second. For 
example, the pipe function would cause the menu to be sent 
to telnet, which obviously would not be desirable. 

"Popen()” creates a file descriptor, which is essentially a 
name for the input side of telnet. Using the file 
descriptor, selected output can be sent to telnet, while 
other information is displayed on the terminal screen. 

As will be discussed more thoroughly in Section I) of 
this chapter, ”tnTops20()" also selectively adjusts the 
terminal modes, which would otherwise cause the keyboard to 
become inactive. It then sends the file "tnTcps20 . text" to 
telnet. The file contains the comm.ands to log in and to 
begin running a certain program if desired. This is an 
example of why the program was designee to be file driven. 
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Figure 7. 



SUBROUTINES "uiTops20()" and "c3La bLini: ( ) 



for changing the program to be run after logging in is 
easily accorrpl ished by editing the tnTops20 .text file. 

The "help()" routine is the first of the standard 
routines which are available in the pregram (Figure 3). It 
consists of a file which is displayed on the terminal and 
contains the basic formats for input to the filter program. 
The file is displayed by typing in "$ help" or "$ ?". The 
number of spaces occunng in the input string between words 
in this case is not significant, e.g., "$ help" and 
"^help" achieve the same result. However, this is not true 
for all input. For the most part, the input to the program 
is in the form of WZS commands, which are handled by the 
"default mode’ of the program, and as such are sent directly 
to telnet (WSh) . 

The second standard routine is ’’quit{)" (Figure 8). 
It is requested in the same manner as the help function, by 
typing in a dollar sign followed by the word quit ("$ 
quit"). Again, the number of spaces between the two words 
is not significant. This routine is used to exit from the 
program, after logging off of the system at NOSC. Logging 
off also causes the telnet process to be terminated, as 
indicated by a message on the terminal when this occv.rs . 

The filter program could simply be aborted at this point, 
however, the output buffer program would still be active, 
the terminal nodes would not be set normally, and certain 
file descriptors would still be open. All the tasKs 
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required tc correct these dei’iciencies are accomplished ty 
”quit()". A message indicating that the filter program is 
being exited properly is cisplayed as these tasks are 
accomplished, failure to use the quit routine will, at 
Dest, result in the display of an operating system prompt 
with input from the keyboard being accepted, but not 
echoed (displayed) on the terminal as it is typed in. 

As previously mentioned in the description of 
"tnTops20( ) ”, a useful connection between the filter program 
and telnet cannot be created using the UNIX pipe facility. 
Rather, the subroutine ”popen()” must be used (Figure 9). 

The creation of a pipe in this manner allows the program to 
send only selected output to telnet. ”?open()" returns a 
file descriptor which, in this case, is essentially the name 
of the input side of telnet. The output which is intended 
for telnet is then directed using this file descriptor. The 
procedure for properly "closing” this file descriptor at the 
end of the program is discussed in the following paragraphs. 
Sufficient comments have been included in the source code to 
provide more details as to exactly how ”popen()" functions. 
No further description of this routine will be included 
here . 

A graceful (i.e., correct in a programming sense) 
termination of the filter program must include a function 
which closes the file descriptor (”fd") which is created in 
”popen()” (Figure 9). This action is accomplished in the 
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subroutine "pclcse()". The caii to "pclcse()" is a part of 
the "quit()" routine which has already been discussed. 

The final subroutine in the program is ”err()*’ 
(i'igure 8). It has been included to sirrplify and 
standardize the inclusion ot error checlcing mechanisms which 
are found throughout the program. The only function it 
performs when it is called is the output of an error message 
on the terminal screen. 

Cue to the fact that the subroutines are file 
driven, all of the files which are required for their 
operation must be available in the directory from which the 
program is executed. If a file is not available, and an 
attempt is made to open it, an error will result which will 
stop the program. This type of catastrophic error could be 
avoided, however, the program would be at test handicapped 
by the absence of a particular file. For this reason, it is 
assumed that both the program and the files which are 
required to run it in its entirety will be available. 
Similarly, the "readTN" program must remain separate from 
the main program, and it too must be in the directory which 
is being used. A straightforward means of insuring that all 
the programs and files are accounted for is tc store them 
all on a tape, and to read the tape when first using the 
filter, or when an error occurs because a required file has 
been changed or deleted. 
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B. THI UNIX INTIRFACI 

In general, ihe UNIX interface was the most 
s tra ight f orwa rl concept to address in designing and 
implementing the filter program. In UNIX, essentially all 
areas where input and/or output can occur are treated as if 
they are files. To a great extent, this allows the user of 
a computer with a UNIX operating system to direct his 
attention to more important aspects of programming. This 
concept is also found in the "C" programming language, which 
is essentially the language of UNIX, and which is the 
language in which this program was written. In "c", 
however, a distinction is made between the standard input 
and output (which are generally the keyboard and terminal 
screen), e data file, and an active computer program 
(process), in that different formats must be used to receive 
input from or direct output to them. In most programs this 
would not be a major concern, but this program by design 
requires the use of all tnree formats. 

As described earlier, the main program causes a second 
program to be executed. This program is called "readTN", 
and buffers the output from telnet (WFS) as required. The 
readTN program runs as a background process, that is, it is 
executed by UNIX independently of the main program. It 
receives its instructions by having access to a file which 
contains a flag, i.e., a character whose value determines 
whether the buffer is to be active or not. The main program 



also has access lo the file containing the flag, and by 
changing the character in the file causes the buffer to be 
enabled ("l”) or disabled ("2”). 

The main program also requests that the telnet process 
be initiated. This operation is handled by a call to the 
UNIX operating system, and will be discussed in more detail 
in the section on the telnet interface. 

C. THE WES OUTPUT BUi'EER PROGRAM 

This program, ’’readTN", is essential to the operation c 
the filter process. Without a buffer, the output from WES 
would be mixed on the terminal screen with the output from 
the process which the user has selected. This would not 
have any effect on either WES or the user program, however, 
it would be at best confusing to the user. An additional, 
and perhaps more sericus problem associated with 
interleaving the two outputs is that the user would be 
required to divide his attention between them. Buffering 
the WES output allows him to concentrate on one issue at a 
time, and to be quickly brought up to date when the second 
process is completed. 

One means of controlling the output of the buffer is to 
use the X-ON/X-OFE feature which is a part of UNIX. In 
short, if the terminal page length ("pagelen") is not zero, 
and "fiowcut" is enabled, the UNIX operating system will 
send the output from WES or from' the buffer program to the 
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lerrrinai screen a page at a tirr.e. To continue with the next 
page, an X-ON , which is currently a "controi-C" , is typed 
in. This character is interpreted by UNIX, but is not 
considered to be a valid input to the program. Similarly, a 
’ control-S" can be used to stop the output before the end of 
a page is reached. Rather than displaying one page at a 
time, a ”control-P" can be used to enter the "zoom moae", in 
which the output dees net stop at the end cf each page. The 
"control-p" is a toggle, that is, a second "centroi-P" 
causes the page length to once again take effect. 

E. TEI TILNET INTERFACE 

Although not obvious in the source code, significant 
problems were encountered in implementing e program which 
provides input to the telnet process. The author of telnet, 
Dan Franklin of Bolt, Beranek, and Newman (BBN), stated that 
he did not anticipate the use of a program to "feed telnet” 
when he wrote the telnet process. He agreed that the input 
terminal becomes disabled when an attempt is made to create 
a connection between a process and telnet. This terminal 
"lockup” is caused by the telnet program, which changes the 
terminal modes in such a manner that nc input can be 
generated from the keyboard. This only occurs when a 
program is used to create the telnet process. With this 
fact in mind, the program was written to reset the modes 
after the telnet process is created, so that the keyboard 



will be reactivated . This is accoinpl i shed in the filter 
program in the subroutine " tnTops2K( ) " . 

The nnain program creates telnet as a means of connecting 
the computer (a PDF 11/72) in the C3 Secure Computer 
Laboratory to one of the virtual machines at the Naval Ocean 
Systems Center (MOSC) in San Diego. Aside from the fact 
that a different operating system is being used after 
logging in to the system at NOSC, telnet itself is 
transparent to the user. It allows programs and processes 
to be run from the terminal as if a physical connection to 
the NOSC computer existed. 






III. A USER'S GUIDE 



The purpose of this section is to provide the user of 
the filter prograrr with a concise, s tep-hy-s tep set of 
instructions to follow in becoming familiar with the filter 
program. This is most easily accomplished by using the 
training mode, since the output of the pregram which would 
normally be sent via telnet to WIS can be displayed on an 
adjacent terminal for easy reference. A copy of a training 
session on the filter program is found in Appendix A. 

Three steps must be followed in order to begin training 
on the filter program. First, the type of terminal being 
used must be specified. This choice is made by simply 
entering the number from the menu which corresponds to the 
type of terminal from which the program is being run. 
Second, a "2" must be entered to use the program in the 
training mode. Finally, the letter which identifies the 
terminal to which the "telnet" output is to be sent must be 
entered. Although the letters which correspond to the Ann 
Arbor terminals are shown on the screen, and a list of all 
possible terminal identifiers is shown, this may not be 
adequate or simple enough to follow. As an alternative, 
"login” on the terminal which is to be used to display the 
output, as well as on the terminal to be used to run the 
filter program. On the keyboard of the display terminal, 
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type "dpy yourname", where ’’yourname" is the naire used to 
login. This will show the upper or lowercase letter which 
corresponds to the terniinal, or tty, immediately following 
the user name. Enter this letter when asked for the "tty 
you want to link to". Note that unlike many programs, the 
filter program reads every character as it is typed in, ana 
a carriage return is not required after an entry is made 
unless it is specifically askea for, or after "$help", 
"$quit", or ’’^macro" is entered. Messages indicating that 
the link is being established, and that the keyboard can 
then be used will be displayed on the input terminal. 

To review the three basic types of entries which can be 
made, enter help", followed by a carriage return. It 
should be noted that this and any other entry which begins 
with a must end with a carriage return (CR), or, in the 

case of macros, alternatively with an escape character. The 
three entries, CR", macro CR", and quit CR” cause 
the menu, a macro expansion, and termination of the program 
to occur respectively. 

In the training mode, a simulated system prompt ("3") is 
displayed on both the input and output terminals, since it 
would be seen if telnet was being used. 

After reviewing the help file, input CR" to display 
the menu of options. Step through each of the six items on 
the menu, returning to the standard WES input mode by 
choosing the sixth option. At this time, the macro 
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expansion capability can be demonstrated. If a copy of the 
file "mac. text" is not available, return to the menu, edit 
the macro list by selecting item 3, and write down one or 
more macros. Enter a followed by the macro (with 

arguments, if any) and end the input with a carriage return. 
If the macro has been entered properly, no error message 
will be displayed, and the WES command(s) will be displayed 
on both the input and the output terminals. Insure that the 
proper number of arguments, in the proper sequence, are 
entered . 

For easy reference, abbreviations for the arguments have 
been included in each macro in "mac. text". For example, "s" 
must be replaced by a ship name, "n" by a flight name, and 

by the quantity of items (e.g. F-14's) which are 
desired. It is anticipated that a paper copy of the macro 
file will be helpful and should be available if a relatively 
large number of macros are being used. The addition of the 
letters to represent the arguments of a macro should also be 
accomplished when a new macro is added to the list, to 
insure that it is properly dccum.ented for future use. 



IV. CONCLUSIONS AND HECON’MENDAT IONS 



A. CONCLUSIONS 

The inpul and ouipui filler program has been 
successfully aemonsiratei lo be a viaole concepi which 
iaierfaces well wiih hoih ibe Warfare Environmeni Slmulaior 
(WES) and ihe user. Al Ihe present lime, the program has 
been tested with WES being run using several different, but 
predetermined scenarios. This approach has been sufficient 
to detect ana correct deficiencies in the prcgrams which 
make up the filter, tut a recommendation for future testing 
and use is made in the next section. 

B. RECOMI^ENDATIONS 

1 . Future Testing 

Although the program was tested cn an incremental 
basis as it was developed, and significant changes were made 
to insure that its use did not interfere with the conduct of 
a WES wargame in any way, mere extensive testing should be 
accomplished as follows. The program should be used during 
a truly interactive wargame, as opposed to the wargames 
which have recently been run in which essentially all orders 
were entered from a prepared script. An interactive wargame 
would be especially useful in evaluating the actual and 
potential value of the most powerful capability which the 
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prograrr. provides, i.e. rracro expansion. Any scenario in 
which the player is i’orced to be active a great deal oi' the 
time would be most useful in accomplishing this evaluation. 

2 . Other Applications 

A general observation and recommendation for further 
work stems from the fact that the iaput/output filter 
concept has an unlimited number of possible applications. 

In general, interactive computer programs such as WES are 
readily accessible, but not flexible cr easy to modify, if 
they can be changed at all. The filter concept, on the 
other hand, provides a mechanism for achieving a wide range 
of flexibility in terms of aids and options which can be 
provided while remaining within the constraints on input 
imposed by an otherwise inflexible process. The general 
structure which has been presented here should serve as an 
adequate baseline from which to develop many variations of 
the filter program. 
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APPENDIX A 



SAMPLE OUTPUT FROM THE FILTER PROGRAM 

The attached text is a copy of the actual output of the 
filter prograr when used in the training rrode. The only 
significant difference between the output shown here and the 
output when the prograrr is used with telnet is as follows. 

In telnet, the echo is provided by the remote host (TGPS20), 
so that both the input echo and the output from WES appear 
in capital letters. 

The copies of the menu of options which occur after it 
is displayed the first time have been removed and replaced 
with "(MENU HERE)". 
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Choose one of the following devices lo link to 
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IS THIS CORRECT ? (TYPE y OR n) - -> y 
LINKING TO Q-'o LAP TERMINAL ItyO- 
RETURNING CONTROL Oi THE EEYROARD TO YOU. 
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Review/Fdil cui txistint’ file. 

See the ciirreni list of filenaires. 
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DISPLAYING THE CUHHENT LIST OF FILENAMES. 
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ELI TING THE MACHO EXPANSION FILE NOW. 
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2? s = ship h = quanilty n = flifjhi name 

2V>q [CAHHIAGE RETURN] (TO EXIT FROM EDN ) 



ORDER PREPARATION - MOT IMPLEMENTED YET 
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THE MAIN PROGRAM 
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l'close( l’p3) ; 

prl ntl' ( ’ %c %c \t\t" ,CR,CR ) 
sy stem( ’ date" ) ; 



prinif ( "\n\lWHAT TYPE OF TERMINAL ARE YOU WORKING ON 

{ji i ntl‘ ( ’ \n\n\t\il . Ann Arnor.") ji 

l)ii nlf ( "\n\t\l2 . Digital VT 100. ) » 

pi i iiil( ' \n\ t\i3 . A.D.M.3 or Tektronix.’’) ; 

priniK ”\n\n\t\i'!‘^^^ TYPE IN 1, 2 OR 3.’‘^’^nn’ ) ; 
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ml = seichar ( ) ; 

sv;itch(ml) Selecilon from opening menu 
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system! modtly echo 
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fpTN = r open ( i inKdev ice , w ) ; 
putc(CR, fpTN) j 

putc ( '0' , IpTN ) > Z’^' To simulate the ...’■V 
printf("0”) ; /’•' system prompt ...^/ 
fclose(fpTN) ; 



break » /’*' = reiurn in this case 






!l 

II 

cz. 



CO 



II 

II 

CVj 



p 

o 

in 

w 



(Li 

> 

o; 

o 

QJ 

pc; 



fX3 

> 



01 









— 






• 


: \ 






G 


O 




































O 


Ps 






















v-» — ^ 






- — - 


: 






M-S 


O 


















• 




\ \ 






: 




• •k 




M 


<T5 






















iT. 






o 


•k 






Ps 


E 






















V \ 






-C 


t 






c 




















-H 










o 




: 






G 


















(D 




11 II 






(LI 


£-• 


G 




Vs 


OJ 






















11 11 






1 








o 


> 














• •k 




fO 












rX3 *-K 


» 






•1-4 






















Cvi 








— i 






p 
















I— i 


S 




isi 


E E 


• 






Vs 






G 
















rH 


' — ^ 


o 


‘T3 


' — ■' — ■" 






4-4> 


: .- 


p 




QJ 


(T3 














X 




<-> 


OJ 




o 




■P 


Pm 


o 




E 










• •k 


• •k 








o 


L, 


— — 






o 


G ^ 


Vs 






Vs 






• •k 








G 


•• cu 




— 


OJ 




E 


U *-P-t 


■ — ^ 




Vs 






• 






G 




03 












tH 


: 


o,x Cm 


s-s 




o 








21 


o 


O 




G 










ro 




> — ■ 


O Ai — 


M> 






OJ 






?;!) 


pO 


• - 


Vs pL| 


-H 






\ 


-H 


11 


£ 


Vh ^ 0) 


C 






<v 




P 


03 


03 


<-> 




P C*s 


p 






rH 




11 


OJ 


— ' 01 


•<-s 




G 


01 




o 


.—s 


-H 


PL 


•G 




03 






\ 


o 




♦-> 


11 o o 


Ps 




CP 






Vs 


Vs 


Vs 


O 






Vs 








M 


c 


01 


*-* -s 


PV 






o 












►s 


G W 


OJ 






II 


o 


o 




Ps :3 


*a 




X- 




• •k 


<-4> 






G> 


03 


rO GJ 


T3 






11 


•40 


m-H 


01 


JCS Ps SH 


Vs 










G 


G 




G 


-G 


x: ^ 












♦-> 








.•k 








•rH 


•«H 


•rH 




P 


O Cm 








CM 




Ps 












CJ 


03 




















:z. 




O 








G 




OJ 


— s 


G 


G 


G 


G 


G 


G G 








— ^ 












Ps 






Vs 


G 


V 


G 


G 


G 


G G 








’ — ' 












P 




O 




OJ 


sLi 


OJ 


03 


Qj 


03 OJ 




















h-> 








«-» 






4-d 


G 










Lh 




Vs 








P 




;c 








X 


X 


?< 


X 








•r-S 




•♦-S 












\ ^ 


•rH 


03 


U 


03 


Qj 


0> 


03 03 



O 

o 

rc 



61 



i a Del D : 

flag = 0 > flag = 0 when NOT a valid macro. 

fiagN = 0 ; /’*' flagN = 0 when macro MAY he found. 

flagCR = 0 > /^' flagCR = 0 when macro not ended by CR 
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Null statement 



sub() ; Create the WES equivalent 

if ( flagCR == 2 ) 
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cont i nue 



sub() i /’•' Create the WES equl va 1 ent . . . . ’‘V 
if ( flagCR == 2 ) 
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CR or escape 
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raclj trn>] != bufferll -* mn] ) 
break i /*■' Go lo nexi matching letter. 
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putc(mac(jj , f pTN ) » 

puichar( maclj] ) J /’'•' Echo lo user le rmi na i . ’'V 



if ( option == 1 ) 
sleep(b) ; 

prinlfr%c \IHETUBN1NG TO THE STANDARD WES INPUT MODE. %c",CR,CR); 
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option == 2 ) 
l.uic(ar^^l li i] , fpTN ) 
prlnif( %c” ,argl [i i] ) 



















• «K 




































r — 1 








1 \ 














•*-» 








•rH 






















-H 






















L_«i 














rH • •«. 








t-^ 






















5^ 




• Vik 




- — N 






fc-i 




^ ^ 




P 














ro — » 




•fH 




rTD 




r-n 






— ' 








fH 




•h 




2 -rH 




+ 






: “I -rH 




+ 




: 




P *rH 




+ 


\ 




CJ ^ — • 




+ 


\ 


CJ 




P*— ' 






SJ 




^ 1-H 






Si 






P tH 










: ^ 




• «k, 


/ 






ixL 






\ 




^ •>.' — ^ ;h 






N 


«fc 




• P 




yo 






♦-» r— ^ no 




rH 




4^ 




— 1 03 




C\i 


II 




rH ^3 CM ^ 




yo 


11 


rH p CM 


•«H » 






II 




o *^: 






II 


O 




•«H ; 




II 






II 4h 11 ' — O 




11 




il v» 


II 


— ' CJ 




\/ 


r— » 




II ' II rH 




\/ 


i—n 


II ^ 


II 












V4 








Vh 




t^z 






»tH 


• «tb 


C H> C fn ^ 




f~t 


•rH 


•- C P> 


c 


P ^ 




H-t 


* 




O a o ^ :m 




•*-i 


L_«J 


o c 


o 


03 P 


— N 


• 


t-H 


•*H »»H mH ■*•— ^ 


^ S. 


••H 


rH 


^ .»H 


•r-4 







Si 


ro 


fH CJ a 




Si 


;;£ OJ p 


r-> 


o p 


\ 


CO 




OJ 


pH pH pH 


> 




p 


CD P P 


P 


♦H -P 


o 


rH 


n? 




O tJ o p P 




CM 




P O 


o 


P P 










:m Ph P^ 








-Q P 




P P 


> 


II 


' — ■ 






> 


II 










il 




v« 




?«-H V* 


II 


•rH 




P 


p 




II 




-r-» ^ 




•rH — *-h 


II 


•rH ' f * 


•rH 


•rH 


•rH 






■ — ' 





















r— 1 


U 








) — » 














o 










o 












v^ 








— i. 


-r-* 











o 


o 




03 




CL 


-- 


— 


p 


P 


■p 


•P 



71 



OJ 

OJ 

-a 

c 

o 

Kn 



dj 



03 



b; 

OJ 



(D 

(/) 













\ 




O 




- — ^ 












<-^ 










03 n 


• 




CJ 






' — ^ 










W 




■r 






m C~* 










+ 


\ 




O — ' 






X* 






S3 




V-l tH 


•*~3 




\ 










; sc 










0^ 


\ 






o 








02 






^ 1 — 1 <v 


03 








CO 


II 




tH P Osi - 


E 










II 




o ■*-»: 


•* 








II 






II V» H — ► O 


; 








N/ 


f— » 




11 ^ 11 ^ ^ 


o 














v-i Cys 






£h 




*rH 






a c t-i — ^ 


: 




j-sr— m 




•rH 


L_i 




o c c ro v^ 


• 




Vs **^ 




• 






•rH ^ ' — .j-i 






1 — * 




S) 


03 


^ P 4^ O C 


P 




O 


V 




(-1 


U3 


p, p^ p, 


o 




1 — 1 03 


w 


o 


03 




o o p P 


Vh 


- — ^ 


E 








.o 


V( P 








\ 


II 


' — < 




^ 


rH Vs 


CM 


o >~- 
















03 P 


II 


•rS 


V-i 




Vs Vs 


II P 


II 


E 03 


II 








**-s ^ » 


II 


11 


— 












P 




o o 


( — \ 










P P 


G 






o 








O T3 


O 


p p 


1 — t , ^ 


C»-i 








Vs 




p p 


o 










i-> 


*-> 




03 










P 


P 




E 










O 


o 




-- 










-- 


— 














Vs 


Vs 














-»H 







S) S) S) 



ti II H II II 

:z 

tH 

» p^ r~i r--i(— n 

Vh r— » GJ 52 S 

—'I — I 5w ,Ai 

OJ S3 QQ 

O ♦ r-H f— I rH tH ■ 

^ 

CJ ^ J-i 

Vh ro fl3 o3 03 03 



72 



i r ( cpiion == 1 ) 
sleep(b) ; 

piinU'(”%c %c',CR,CH) ,' 

printl‘( "NiHETURNING TO THE STANDARD WES INPUT MODE. %c",CR) 
r f 1 11 r n » 
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char arglVlJ ; 

extern ini option 
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arg[0j = 'e' »’ 
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sysieni( nodity -echo 



printf (’'%cXc\tDISPLAYING THE CURRENT LIST Oi FILENAMES CR , CR ) 
printl‘(^%c%c’' ,CR,CR) ; 
system ("is | me") > 



>* 

CQ 



to 

•»— t 

T 3 






/\ 

I 

I 



:d 



w 

a- 

o 



ZD 

£-• 

a: 

9 

£-• 

PC 

W 



lH 

V 

O 

o 

03 

E 

o 



o 


c 


«< 


OJ 


« 






Lh 




p 


CP 


o 


>-• 


sLI 



PC 

CP 




«-» 






:s 


Ph 




UJ 


O >H 




•rH 


5^ £-» 




> 


O <tJ 




OJ 


-P 




PC 


; ; o 







^ V-» CL) 
♦-J ♦-> 

II 

Pi 



P 



1 ) 



o 

o 

- 

p> 







\ 




\ 






rr 


vr 


> 4 * 






• 


• 


• 






(D 












o 




PC 




4 -^ 


<-> 




CP 






p 




•> 




•P 






PC 




P 






CP 




rO 


to 


• 


•* 






c 


: 


m 




4 ^ 


o 


o 


• 




in 


•»-M 


03 


3 c 




•<-4 


4 -> 


E 


O 




r-H 


p 


: 


~2Z 






4 -» 








o 






W 




u 


4 -> 


03 


i-P 




o 


to 


Xi 


HH 




03 


P 3 


U 






E 


P 


03 








to 








OJ 




QJ 


o 




X 


V -1 


X 


»— » 




4 -> 


o 


4^ 


CO 










2 : 




•p 


4 -> 








03 










Oj 


1-4 




X 




X 


— ♦ 






















X- 


o 




\ 


\ 


\ 


PC 




• 






CP 








V 










w 


2 : 


* - — « 


» 




o 




; ; 






w 


Pm 


4 -» 4 -^ 








X 


)X| H 


CD Xi 




il 


C -4 


OJ 0 ) 


4 -^: 




— 




♦-> 4 -> 


• 






O •- 


• • 


o • 




V • «K 


2 : 


o o 


ro: 








fT 3 03 


E )-* 




r-M C^J 


=-• X 


p b. 






X E 


o 




P OJ 




C -4 


« •- 


«X 3 ♦-> 


T 3 




' Il 


X 




OJ • 




o 


CP 


r-»; :\it 


CO: o 




4 -* — ^ 


/ • 


W ' ' — ' 


— ^ rX 3 




QJ 


: 


il b !1 b 


II E E 




txO -t 


O O 


II OJ n QJ 


!l oj: 




-1- 




4 -i 






II “ 




Oj cn OJ to 


QJ to P 




CP 


o o 


X >a ex 


Pi QJ 




'O ^ 


^ ^ ^ 


>a ^ cn 


to ex 




E b 


ex: : 


*-s *-» 


♦-> o 




— " 




E E 


E ^ 


• 


- — ^ 


V-» V-» 


P Xi 


Xi 








OJ OJ 


CD 11 




CD 


WPP 


*-> ^ 






/-H 


W >rH .r -4 


•S^ ■■ " 


t-M 


II 




t— < P P 


^ X-< 


Vh ex 






-*-♦ ex ex 


•rH 


*H V 4 


f-4 


3 



76 



fcl cse ( I'pl ) 



0 rderPrep ( ) Prepare an order lor Inpui to WFS... 

{ /’t' NOT A COMPLETE FUNCTION YET 
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prinlll ,CR) » 

printf("\t (THl STANDARD WES INPUT MODE) 

printf(”%c" ,CR) ] 

I'd pri n t f ( f ou t , , CR ) j Pipe is on here. 

I' e i u r n ; 



char b ; 
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char dev2 [4] » 

extern char devicellif] 
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goto 1 a bel6 
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fpii = f open ( help . text ’ , ’ r' ) » 
while ((tr6 = getc(fp£;)) 1= EOF) 
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prinlfC'Xc NOT A VALID 1 NPUT .’i‘=P=<' TRY AGAIN. %c",CR,CR) 

printl-C'%c %c",CR,CR) J 



FF = Fopen ( "f lagTN* , ”w") »' 

yuic (''d' , FP) ; /’!‘ Receive WES output 

fclose(EP) ; 
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THE MAIN PROGRAM TEXT FILES 
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(THE "[" ABOVE INDICATES A CONTROL CHARACTER) 
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t'OLLOWtD BY A CARBlAGE RETURN 
FOR EXAMPLE > ttyL 
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/^ Buffer WES output 



012) II ( b == 015)) When at the end of a line. 

/’t' check the buffer flag 
= f open ( "f lagTN" , "r") » 
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save! = i » Keep track of output in the buffer 

i = 0 ; /^' Begin overwriting buffer 



flag == 0) Buffer has NOT been filled 
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i = Go to the beginning of the buffer 

flag = 01 Buffer has been flushed 

return »* 
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